home *** CD-ROM | disk | FTP | other *** search
/ W95 Shareware Collection / W95 Collection - Windows 95 Shareware (LCDCAN).iso / win95 / programm / mdf45 / mdf_ita.doc < prev    next >
Encoding:
Text File  |  1995-08-21  |  15.3 KB  |  407 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                   MDIFF  -  MPATCH
  12.                                     Release  1.45
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.           Un software semplice ma completo per produrre e applicare patch a
  24.           programmi e file di dati per Dos, OS/2, Windows 95 e Windows NT.
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                              Manuale in lingua italiana.
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.                (C) 1995/96 Maurizio Giunti - Tutti i diritti riservati
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.      1.SOMMARIO
  54.  
  55.  
  56.      1.SOMMARIO                                                               2
  57.  
  58.  
  59.      2.DIRITTI                                                                3
  60.  
  61.  
  62.      3.GARANZIE                                                               3
  63.  
  64.  
  65.      4.PERCHE'                                                                3
  66.  
  67.  
  68.      5.A COSA SERVE                                                           3
  69.  
  70.  
  71.      6.DOS, OS/2, WINDOWS 95 E WINDOWS NT                                     4
  72.  
  73.  
  74.      7.LIMITI                                                                 4
  75.  
  76.  
  77.      8.MDIFF - MDIFF2 - MDIFFW                                                4
  78.  
  79.  
  80.      9.MPATCH - MPATCH2 - MPATCHW                                             5
  81.  
  82.  
  83.      10.MDF2EXE - MDF2EXE2 - MDF2EXEW                                         5
  84.  
  85.  
  86.      11.ALCUNI CONSIGLI                                                       6
  87.  
  88.  
  89.      12.LIBRERIE PER APPLICARE PATCH                                          6
  90.  
  91.  
  92.      13.COME REGISTRARSI                                                      6
  93.  
  94.  
  95.      14.RINGRAZIAMENTI                                                        7
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.                                                                               2
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.      2.DIRITTI
  115.      Questo  software   appartiene alla categoria   dei  programmi  Shareware:
  116.      chiunque lo puo'  liberamente copiare ed   utilizzare per  un periodo  di
  117.      prova di    15 giorni.    Dopo   tale   periodo,  l'utente  che  desideri
  118.      continuare ad    utilizzarlo e'  tenuto  a registrare  la  propria  copia
  119.      inviando la quota di registrazione all'autore, Maurizio Giunti.
  120.      Gli utenti che pagano la quota  di registrazione riceveranno una  "chiave
  121.      di registrazione" personale e non cedibile, che rendera'  "registrata" la
  122.      propria copia del programma.
  123.      Chiunque puo' ridistribuire questo software a condizione che non richieda
  124.      alcuna somma di denaro in cambio, fatta  eccezione per le spese  di copia
  125.      e/o di spedizione che, pero', devono essere adeguatamente documentate.
  126.      Altra condizione per la libera distribuzione e' che venga  sempre fornito
  127.      per intero il contenuto del pacchetto di  distribuzione  originale, senza
  128.      alcuna modifica ai programmi e/o alla documentazione.
  129.      Un'unica  eccezione:  il   programma  MPATCH   puo'  essere   liberamente
  130.      ridistribuito insieme ad uno o piu'  files *.MDF  prodotti con una  copia
  131.      REGISTRATA di MDIFF.
  132.  
  133.  
  134.  
  135.        GARANZIE
  136.      3.
  137.      L'unica garanzia  fornita con  questo software  e' che  occupa spazio  su
  138.      disco. Non posso  assolutamente garantire che   funzioni perfettamente  o
  139.      rappresenti la soluzione di ogni vostro problema. Sono inoltre sicuro che
  140.      non e' un virus e   non contiene (a meno che non  sia stato infettato   o
  141.      modificato  dopo  la  compilazione)  Trojan-Horses,  Back-Doors  o  altre
  142.      diavolerie simili.  In ogni  caso l'autore  declina ogni  responsabilita'
  143.      diretta o indiretta, per  eventuali danni   morali o materiali  derivanti
  144.      dal suo uso.
  145.  
  146.  
  147.  
  148.      4.PERCHE'
  149.      Qualche tempo  fa dovevo  rilasciare una  versione aggiornata  di un  mio
  150.      programma: il pacchetto compresso "pesava"  piu' di 200 Kbyte,  e sarebbe
  151.      stato sicuramente  piu'  conveniente  per  tutti  aggiornare  il  vecchio
  152.      eseguibile tramite una patch.   Mi misi in caccia  di un software che  mi
  153.      permettesse di creare e distribuire patch  dei miei programmi  per Dos  e
  154.      OS/2: per Dos ne ho trovati alcuni (ma non mi hanno soddisfatto  per vari
  155.      motivi),  per  OS/2  neanche  uno!  Ho  quindi  deciso  di   farmene  uno
  156.      e....eccolo qui ! 8-)
  157.  
  158.  
  159.  
  160.        A COSA SERVE
  161.      5.
  162.      MDIFF crea un file binario  di differenza tra due  file. Con MPATCH e  il
  163.      vecchio file  si  puo' ricreare  il  nuovo file    partendo dal  file  di
  164.      differenza. Cosa c'e' di buono in tutto cio'? Semplice: supponendo che il
  165.      file di differenza sia   piu' breve del  nuovo file, e' piu'  conveniente
  166.      distribuire solo  quello  invece di  tutto  il file,  soprattutto  se  la
  167.      distribuzione avviene via modem.
  168.  
  169.  
  170.                                                                               3
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.      6.DOS, OS/2, WINDOWS 95 E WINDOWS NT
  179.      MDIFF e  MPATCH  per  Dos,  OS/2  e  Windows  sono  ottenuti  tramite  la
  180.      compilazione dei  medesimi sorgenti,  quindi non  c'e' alcuna  differenza
  181.      nella funzione e nell'uso di tali  programmi sui vari sistemi  operativi.
  182.      Inoltre i  files  *.MDF  prodotti  con  MDIFF per    Dos  possono  essere
  183.      utilizzati con MPATCH per OS/2 o Windows e viceversa.
  184.  
  185.  
  186.  
  187.        LIMITI
  188.      7.
  189.      MDIFF non puo' trattare files piu' ampi di 16 Megabyte. Questo e' l'unico
  190.      limite fisico generale di MDIFF.
  191.      Inoltre MDIFF per OS/2, essendo ottenuto tramite una compilazione diretta
  192.      dei sorgenti di MDIFF per Dos, non e' in grado di trattare  gli attributi
  193.      estesi, quindi si limitera' ad ignorarli.
  194.  
  195.  
  196.  
  197.      8.MDIFF - MDIFF2 - MDIFFW
  198.      Il programma MDIFF si occupa di comparare due files e di immagazzinare le
  199.      differenze tra di essi in un terzo file  che, generalmente, e' molto piu'
  200.      compatto. Vediamo come si usa:
  201.  
  202.         MDIFF [-C<c>] [-R<r>] [-F<f>] [-S] [-Z] [-P<pwd>] <OldFile> <NewFile>
  203.                                      [<MDFfile>]
  204.  
  205.      <OldFile> ovviamente e'  il nome  della versione precedente  del file  da
  206.      comparare, mentre  <NewFile>  e' il  nome  della   versione  attuale.  Se
  207.      necessario si puo' specificare il nome  del file di differenza da  creare
  208.      <MDFfile>, altrimenti   MDIFF  crea un  file  che ha  lo stesso  nome  di
  209.      <NewFile> ma estensione ".MDF".  Per cercare le  parti simili nei  files,
  210.      MDIFF si serve di una stringa base di lunghezza predefinita  detta chunk.
  211.      La lunghezza del chunk e' per default di  16 byte ma puo' essere cambiata
  212.      (in un range  4-256) con  lo switch  -C seguito  dalla lunghezza  voluta.
  213.      Quando  MDIFF perde il sincronismo tra i due files che  sta confrontando,
  214.      cerca di ritrovarlo scandendo il vecchio file alla  ricerca del chunk che
  215.      sta elaborando. Tale ricerca viene effettuata, in un  intorno dell'ultimo
  216.      chunk trovato, nel range definito dallo switch -R. Per default tale range
  217.      e' di 8 blocchi di 512 byte, ma puo' variare tra 1 e 16. Se tale  ricerca
  218.      fallisce MDIFF cerca di forzare il sincronismo cercando in un raggio piu'
  219.      ampio di quello definito solitamente ampio 1/16 della lunghezza del file.
  220.      Questa seconda  ricerca puo'  essere disabilitata  o  il suo  range  puo'
  221.      essere cambiato tramite lo  switch -F. Specificando lo  switch  -S,  alla
  222.      fine dell'operazione, MDIFF  fornira' alcuni dati sulla  composizione del
  223.      file di differenza.
  224.      E' inoltre  possibile,  tramite  lo  switch  -Z,  inserire  nel  file  di
  225.      differenza un breve commento (al massimo 2 Kbyte), che sara' visualizzato
  226.      durante l'applicazione della patch da parte di MPATCH. Il  commento viene
  227.      prelevato direttamente  dallo  standard  input e  quindi  puo'  essere  o
  228.      digitato o prelevato da un file tramite l'apposito comando di redirezione
  229.      "<".
  230.      Tramite lo  switch  -P si  puo'  proteggere  la patch  con  una  password
  231.      (<pwd>): chi non conosce tale password non potra' applicare la patch.
  232.                                                                               4
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.      9.MPATCH - MPATCH2 - MPATCHW
  242.      MDIFF sarebbe  un  programma inutile  se  non esistesse  MPATCH.  Infatti
  243.      MPATCH si occupa,  dati <OldFile>  e  <MDFfile>,  di ricreare  <NewFile>.
  244.      Vediamo come si usa:
  245.  
  246.                  MPATCH [-P<pwd>] <MDFfile> [<OldFile> [<NewFile>]]
  247.  
  248.      L'unico parametro necessario e' il nome del file di  differenza <MDFfile>
  249.      perche' esso  contiene i  nomi degli  altri due   file,  ma e'  possibile
  250.      modificare tale impostazione   semplicemente specificando  i nomi  voluti
  251.      nell'esatto  ordine.  MPATCH  ha  il  solo  switch  -P  che  permette  di
  252.      specificare una eventuale password necessaria per applicare la patch.
  253.      In  caso  di  errore  MPATCH  ritorna  un  errorlevel  che   deve  essere
  254.      interpretato secondo la seguente tabella:
  255.         Codice   Descrizione
  256.                  "OK!"
  257.           0
  258.                  "Out of memory !"
  259.           1
  260.                  "Can't open MDF file !"
  261.           2
  262.                  "Invalid MDF file !"
  263.           3
  264.                  "MDF file version mismatch !"
  265.           4
  266.                  "UNREGISTERED !"
  267.           5
  268.                  "Bad or incorrect OLD file !"
  269.           6
  270.           7      "Can't open OLD file !"
  271.                  "Can't create NEW file !"
  272.           8
  273.                  "General failure: NEW file corrupted !"
  274.           9
  275.                  "OLD and NEW can't be the same file !"
  276.           10
  277.                  "NEW file was already patched ! "
  278.           11
  279.                  "Bad password !"
  280.           12
  281.  
  282.  
  283.  
  284.         MDF2EXE - MDF2EXE2 - MDF2EXEW
  285.      10.
  286.      MDF2EXE si occupa di trasformare un file di patch *.MDF creato  con MDIFF
  287.      in un file ESEGUIBILE autoinstallante per Dos (MDF2EXE),  OS/2 (MDF2EXE2)
  288.      o Windows 95/Windows NT (MDF2EXEW).
  289.      Il  file  cosi'  creato  conterra'  al   suo  interno  il  programma   di
  290.      installazione e un certo numero di file di patch (al massimo 127).
  291.      La sintassi per creare una patch autoinstallante e':
  292.  
  293.            MDF2EXE <mdf_file 1> [<mdf_file 2>....<mdf_file n>] <exe_file>
  294.  
  295.      I vari  <mdf_file x>  possono contenere  anche wildcard,  in questo  caso
  296.      MDF2EXE crchera' automaticamente i files da inserire.
  297.      Il file eseguibile creato (che DEVE avere estensione .EXE)  potra' essere
  298.      avviato  senza  alcun  parametro  sulla  linea  di  comando  e  cerchera'
  299.      automaticamente  i  file   da  aggiornare.   Opzionalmente  puo'   essere
  300.      utilizzato lo switch -P per specificare una password oppure gli switch -V
  301.      o -L per visualizzare la lista delle patch contenute nel file.
  302.      Un'unica nota: non comprimete le patch autoinstallanti con  pklite, lzexe
  303.      o altri software simili, altrimenti esse cesseranno di funzionare.
  304.  
  305.  
  306.                                                                               5
  307.  
  308.  
  309.  
  310.  
  311.  
  312.      11.ALCUNI CONSIGLI
  313.      Il metodo ottimale per costruire un file di differenza sarebbe  quello di
  314.      ricercare per tutto  il vecchio file  i chunks   che compongono il  nuovo
  315.      file;  ovviamente  tale  metodo  sarebbe  di  una  lentezza  esasperante.
  316.      L'algoritmo su  cui  e'   basato  MDIFF rappresenta  un  compromesso  tra
  317.      risultato e velocita'  di esecuzione,  per questo  e' talvolta  opportuno
  318.      regolare i  parametri  di funzionamento  di  MDIFF tramite  gli  appositi
  319.      switch. Vediamo come comportarsi in  alcune situazioni tipiche:
  320.        File con pochissime modifiche: e'  opportuno utilizzare un chunk  molto
  321.      1. 
  322.        ampio (32,  64  o piu')  in  modo da    ridurre il  piu'  possibile  le
  323.        dimensioni del file di differenza, soprattutto se si sta' lavorando con
  324.        files di testo o con archivi.
  325.      2. 
  326.        File di testo: di solito un chunk di dimensione 32 e' il piu' indicato,
  327.        e' opportuno provare  a diminuire  o togliere il   sincronismo  forzato
  328.        tramite lo switch -F.
  329.        File eseguibili molto  ampi: spesso   si  ottengono risultati  migliori
  330.      3. 
  331.        allargando il range di ricerca del  sincronismo  tramite lo switch -R.
  332.      Un ultimo consiglio:  non attendetevi miracoli  da MDIFF. Se  i due  file
  333.      confrontati sono molto dissimili il file di patch risultera' molto ampio.
  334.      In questi casi c'e' ben poco  da fare, bisogna rassegnarsi a  distribuire
  335.      il nuovo file  interamente. MDIFF e'  realmente utile solo  se il  numero
  336.      delle modifiche apportate ai file non e' troppo grande.
  337.  
  338.  
  339.  
  340.         LIBRERIE PER APPLICARE PATCH
  341.      12.
  342.      Fino alla  release 1.40  nel pacchetto  di distribuzione  di MDIFF  erano
  343.      contenute anche  alcune  librerie per  Dos,  Windows e  OS/2,  utili  per
  344.      realizzare propri programmi per applicare patch.
  345.      A causa dello  scarso feedback  dell'utenza e della  diminuzione del  mio
  346.      tempo libero ho deciso di non continuare a distribuire tali librerie.
  347.      In ogni  caso  cerchero' di  portarne  avanti lo  sviluppo  trascurandone
  348.      invece i manuali, per cui se  qualcuno fosse DAVVERO interessato ad  esse
  349.      non esiti a contattarmi.
  350.  
  351.  
  352.  
  353.      13.COME REGISTRARSI
  354.      Il costo della  chiave di  registrazione individuale, valida  sia per  la
  355.      versione Dos che  per quelle OS/2  e Windows, per  tutte le release  fino
  356.      alla 1.99 compresa, e' di 25.000 lire italiane (circa 16 U.S.$)  spese di
  357.      spedizione comprese. Il  codice di registrazione  sara' spedito   tramite
  358.      normale lettera, oppure, a richiesta, via E-mail.
  359.      La  registrazione  puo'  essere  effettuata  in  qualsiasi  modo,  ma  e'
  360.      consigliabile  l'utilizzo di  vaglia  postale  in Italia o  International
  361.      Postal Check in Lire Italiane dall'estero, pagabile all'ufficio   postale
  362.      di "FIRENZE" ed intestato al  seguente nominativo:
  363.  
  364.                                    Maurizio Giunti
  365.                                 Via G.B. Foggini, 24
  366.                                  50142 Firenze (FI)
  367.                                         ITALY
  368.  
  369.      Per i residenti  in Europa  puo' essere  piu' conveniente  l'invio di  un
  370.      Eurocheque in Lire Italiane.
  371.                                                                               6
  372.  
  373.  
  374.  
  375.  
  376.  
  377.      In ogni caso ricordate di indicare  il nome del programma da  registrare,
  378.      il vostro nome, cognome, indirizzo e indirizzo e-mail (se necessario). Se
  379.      siete utenti  Fidonet  o  Internet e  necessitate  di  delucidazioni  non
  380.      esitate a spedirmi un e-mail ai seguenti indirizzi:
  381.  
  382.                                 Fidonet: 2:332/102.3
  383.  
  384.                              Internet: giunti@abeline.it
  385.  
  386.  
  387.  
  388.      14.RINGRAZIAMENTI
  389.      Vorrei brevemente  ringraziare  gli  amici che  mi  hanno  aiutato  nello
  390.      sviluppo di questo software  e della  documentazione  allegata, o che  si
  391.      sono coraggiosamente offerti come beta-testers. In ordine alfabetico:
  392.  
  393.  
  394.                                    Andrea Baitelli
  395.  
  396.                                     Silvia Borri
  397.  
  398.                                     Filippo Dini
  399.  
  400.                                  Fabrizio Fioravanti
  401.  
  402.                                  Cristiano Guidoccio
  403.  
  404.                                 Giovanni Lopes Pegna
  405.  
  406.                                   Marco Maccaferri
  407.  
  408.                                   Marco Menichelli
  409.  
  410.                                    Giuseppe Scarpi
  411.  
  412.                                    Toni Tatafiore
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.                                                                               7
  433.  
  434.